Description

Add RNSLifecycleListenerProtocol to allow external view controllers (such as third-party bottom sheets) to receive screen lifecycle events when a screen in the presenting hierarchy is about to disappear.

This is useful for external modal implementations that need to know when the presenting screen is being unmounted (e.g., when navigating back) so they can dismiss themselves appropriately.

Changes

• Added new RNSLifecycleListenerProtocol in ios/integrations/
• Modified RNSScreen.mm:
  • Added _controllerBeforeInvalidate ivar to preserve controller reference before invalidation
  • Updated notifyWillDisappear to notify conforming presented view controllers
  • Updated invalidateImpl to store controller before nulling
• The protocol method screenWillDisappear:isPresenterUnmounting: provides:
  • The screen controller that is disappearing
  • A flag indicating if the presenter (modal) itself is being unmounted

Before & after - visual documentation

Before

After

Test plan

1. Present a third-party modal (e.g., TrueSheet) that conforms to RNSLifecycleListenerProtocol
2. Navigate back (pop the screen) while the modal is open
3. The modal should receive screenWillDisappear:isPresenterUnmounting: callback
4. The modal can use this to dismiss itself when the presenting screen is popped

Example conformance:

@interface MyModalController : UIViewController <RNSLifecycleListenerProtocol>
@end

@implementation MyModalController

- (void)screenWillDisappear:(UIViewController *)screen isPresenterUnmounting:(BOOL)isPresenterUnmounting {
  if (!isPresenterUnmounting) {
    // Screen is being popped, dismiss ourselves
    [self.presentingViewController dismissViewControllerAnimated:YES completion:nil];
  }
}

@end

Checklist

• Included code example that can be used to test this change.
• Updated / created local changelog entries in relevant test files.
• For visual changes, included screenshots / GIFs / recordings documenting the change.
• For API changes, updated relevant public types.
• Ensured that CI passes